啟用軸的別名索引與所有函式的 I/O 索引參數。別名索引需第一個設定，使應用程式能有不同於實體 EtherCAT 連結的伺服器順序。
語法
KsError EnableAliases(
BOOL Active
);參數
Active：此參數決定是否使用別名，設置 TRUE 以啟用；FALSE 停用別名，預設為 FALSE。
回傳值
如果此函式執行成功，會回傳 errNoError，否則會傳回錯誤碼。如需更多有關錯誤碼的資訊，請參閱 KsError 清單。
備註
獲取各驅動器的細節，並使用供應商、產品與別名來識別各驅動器，若驅動器未依正確順序插入，請重新排列驅動器的列表，並在 KINGSTAR 子系統開始後使用此函式。
可用的 EtherCAT 狀態
ecatOP
範例
複製
// Define aliases for axes
#define AxisX 101
#define AxisZ 102
#define AxisC 103
// Apply the aliases
nRet = WriteAxisAlias(1, AxisX);
nRet = WriteAxisAlias(2, AxisZ);
nRet = WriteAxisAlias(0, AxisC);
nRet = EnableAliases(TRUE);使用需求
| RT | Win32 | |
|---|---|---|
| 最低支援版本 | 4.0 | 4.0 |
| 標頭檔 | ksapi.h | ksapi.h |
| 程式庫 | KsApi_Rtss.lib | KsApi.lib |
參見